home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / faq / comp / graphics / gnuplot_ / text0000.txt < prev   
Encoding:
Text File  |  1994-04-10  |  35.5 KB  |  828 lines

  1.  
  2. Archive-name: graphics/gnuplot-faq
  3. Version: $Header: gnuplot-faq.html,v 1.11 94/04/05 00:45:18 ig25 Exp $
  4. Posting-frequency: every 14 days
  5. X-Url: http://fg20.rz.uni-karlsruhe.de/~ig25/gnuplot-faq.html
  6.  
  7.    comp.graphics.gnuplot
  8.    
  9.             COMP.GRAPHICS.GNUPLOT FAQ (FREQUENT ANSWERED QUESTIONS)
  10.                                        
  11.    This is the FAQ (Frequently Answered Questions) list of the
  12.    comp.graphics.gnuplot newsgroup, which discusses the gnuplot program
  13.    for plotting 2D - and 3D - graphs.
  14.    
  15.    Most of the information in this document came from public discussion
  16.    on comp.graphics.gnuplot; quotations are believed to be in the public
  17.    domain.
  18.    
  19.    Here's a list of the questions. If you are looking for the answer for
  20.    a specific question, look for the string Qx.x: at the beginning of a
  21.    line, with x.x being the question number. Sections in this FAQ are
  22.      * 0. Meta - Questions
  23.      * 1. General Information
  24.      * 2. Setting it up
  25.      * 3. Working with it
  26.      * 4. Wanted features
  27.      * 5. Miscellaneous
  28.      * 6. Making life easier
  29.      * 7. Known problems
  30.      * 8. Credits
  31.        
  32.    
  33.      _________________________________________________________________
  34.    
  35. Questions:
  36.  
  37.   SECTION 0: META - QUESTIONS
  38.      * Q0.1: Where do I get this document?
  39.      * Q0.2: Where do I send comments about this document?
  40.        
  41.   SECTION 1: GENERAL INFORMATION
  42.      * Q1.1: What is gnuplot?
  43.      * Q1.2: How did it come about and why is it called gnuplot?
  44.      * Q1.3: Does gnuplot have anything to do with the FSF and the GNU
  45.        project?
  46.      * Q1.4: What does gnuplot offer?
  47.      * Q1.5: Is gnuplot suitable for batch processing?
  48.      * Q1.6: Can I run gnuplot on my computer?
  49.        
  50.   SECTION 2: SETTING IT UP
  51.      * Q2.1: What is the current version of gnuplot?
  52.      * Q2.2: Where can I get gnuplot?
  53.      * Q2.3: How do I get gnuplot to compile on my system?
  54.      * Q2.4: What documentation is there, and how do I get it?
  55.        
  56.   SECTION 3: WORKING WITH IT
  57.      * Q3.1: How do I get help?
  58.      * Q3.2: How do I print out my graphs?
  59.      * Q3.3: How do I include my graphs in <word processor>?
  60.        
  61.   SECTION 4: WANTED FEATURES
  62.      * Q4.1: Does gnuplot have hidden line removal?
  63.      * Q4.2: Does gnuplot support bar-charts/histograms/boxes?
  64.      * Q4.3: Does gnuplot support multiple y-axes on a single plot?
  65.      * Q4.4: Can I put multiple plots on a single page?
  66.      * Q4.5: Can I put both data files and commands into a single file?
  67.      * Q4.6: Can I put Greek letters and super/subscripts into my labels?
  68.      * Q4.7 Can I do 1:1 scaling of axes?
  69.      * Q4.8: Can I put tic marks for x and y axes into 3d plots?
  70.      * Q4.9: Does gnuplot support a driver for ?
  71.      * Q4.10: Can I put different text sizes into my plots?
  72.        
  73.   SECTION 5: MISCELLANEOUS
  74.      * Q5.1: I've found a bug, what do I do?
  75.      * Q5.2: Can I use gnuplot routines for my own programs?
  76.      * Q5.3: What extensions have people made to gnuplot? Where can I get
  77.        them?
  78.      * Q5.4: Can I do heavy - duty data processing with gnuplot?
  79.      * Q5.5: I have ported gnuplot to another system, or patched it. What
  80.        do I do?
  81.        
  82.   SECTION 6: MAKING LIFE EASIER
  83.      * Q6.1: How do I plot two functions in non - overlapping regions?
  84.      * Q6.2: How do I run my data through a filter before plotting?
  85.      * Q6.3: How do I make it easier to use gnuplot with LaTeX?
  86.      * Q6.4: How do I save and restore my settings?
  87.      * Q6.5: How do I plot lines (not grids) using splot?
  88.      * Q6.6: How do I plot a function f(x,y) which is bounded by other
  89.        functions in the x-y plain?
  90.      * Q6.7: How do I get rid of <feature in a plot>?
  91.        
  92.   SECTION 7: KNOWN PROBLEMS
  93.      * Q7.1: Gnuplot is not plotting any points under X11! How come?
  94.      * Q7.2: My isoline data generated by a Fortran program is not
  95.        handled correctly. What can I do?
  96.      * Q7.3: Why does gnuplot ignore my very small numbers?
  97.      * Q7.4: Gnuplot is plotting nothing when run via gnuplot <filename>!
  98.        What can I do?
  99.      * Q7.5: My formulas are giving me nonsense results! What's going on?
  100.        
  101.   SECTION 8: CREDITS
  102.   
  103.    
  104.      _________________________________________________________________
  105.    
  106. Questions and Answers:
  107.  
  108.   SECTION 0: META - QUESTIONS.
  109.   
  110.     Q0.1: Where do I get this document?
  111.           This document is posted about once every two weeks to the
  112.           newsgroups comp.graphics.gnuplot, comp.answers and
  113.           news.answers. Like many other FAQ's, its newest (plaintext)
  114.           version is available via anonymous ftp from
  115.           ftp://rtfm.mit.edu/pub/usenet/news.answers/graphics/gnuplot-faq
  116.           .
  117.           
  118.           If you have access to the WWW, you can get the newest version
  119.           of this document from
  120.           http://fg20.rz.uni-karlsruhe.de/~ig25/gnuplot-faq.html
  121.           
  122.    Q0.2: Where do I send comments about this document?
  123.           Send comments, suggestions etc. via e-mail to Thomas Koenig ,
  124.           ig25@rz.uni-karlsruhe.de or ig25@dkauni2.bitnet.
  125.           
  126.    
  127.      _________________________________________________________________
  128.    
  129.   SECTION 1: GENERAL INFORMATION
  130.   
  131.     Q1.1: What is gnuplot?
  132.           Gnuplot is a command-driven interactive function plotting
  133.           program. It can be used to plot functions and data points in
  134.           both two- and three- dimensional plots in many different
  135.           formats, and will accommodate many of the needs of today's
  136.           scientists for graphic data representation. Gnuplot is
  137.           copyrighted, but freely distributable; you don't have to pay
  138.           for it.
  139.           
  140.    Q1.2: How did it come about and why is it called gnuplot?
  141.           The authors of gnuplot are:
  142.           
  143.           Thomas Williams, Colin Kelley, Russell Lang, Dave Kotz, John
  144.           Campbell, Gershon Elber, Alexander Woo and many others.
  145.           
  146.           The following quote comes from Thomas Williams:
  147.           
  148.      I was taking a differential equation class and Colin was taking
  149.      Electromagnetics, we both thought it'd be helpful to visualize the
  150.      mathematics behind them. We were both working as sys admin for an EE
  151.      VLSI lab, so we had the graphics terminals and the time to do some
  152.      coding. The posting was better received than we expected, and
  153.      prompted us to add some, albeit lame, support for file data.
  154.      
  155.      Any reference to GNUplot is incorrect. The real name of the program
  156.      is "gnuplot". You see people use "Gnuplot" quite a bit because many
  157.      of us have an aversion to starting a sentence with a lower case
  158.      letter, even in the case of proper nouns and titles. Gnuplot is not
  159.      related to the GNU project or the FSF in any but the most peripheral
  160.      sense. Our software was designed completely independently and the
  161.      name "gnuplot" was actually a compromise. I wanted to call it
  162.      "llamaplot" and Colin wanted to call it "nplot." We agreed that
  163.      "newplot" was acceptable but, we then discovered that there was an
  164.      absolutely ghastly pascal program of that name that the Computer
  165.      Science Dept. occasionally used. I decided that "gnuplot" would make
  166.      a nice pun and after a fashion Colin agreed.
  167.      
  168.    Q1.3: Does gnuplot have anything to do with the FSF and the GNU
  169.           project?
  170.           Gnuplot is neither written nor maintained by the FSF. It is not
  171.           covered by the General Public License, either.
  172.           
  173.           However, the FSF has decided to distribute gnuplot as part of
  174.           the GNU system, because it is useful, redistributable software.
  175.           
  176.    Q1.4: What does gnuplot offer?
  177.           
  178.           + Plotting of two - dimensional functions and data points in
  179.             many different styles (points, lines, error bars)
  180.           + plotting of three - dimensional data points and surfaces in
  181.             many different styles (contour plot, mesh).
  182.           + support for complex arithmetic
  183.           + self - defined functions
  184.           + support for a large number of operating systems, graphics
  185.             file formats and devices
  186.           + extensive on-line help
  187.           + labels for title, axes, data points
  188.           + command line editing and history on most platforms
  189.             
  190.    Q1.5: Is gnuplot suitable for batch processing?
  191.           Yes. You can read in files from the command line, or you can
  192.           redirect your standard input to read from a file. Both data and
  193.           command files can be generated automatically, from data
  194.           acquisition programs or whatever else you use.
  195.           
  196.    Q1.6: Can I run gnuplot on my computer?
  197.           Gnuplot is available for a number of platforms. These are: Unix
  198.           (X11 and NeXTSTEP), VAX/VMS, OS/2, MS-DOS, Amiga, MS-Windows,
  199.           OS-9/68k, Atari ST and the Macintosh. Modifications for NEC
  200.           PC-9801 are said to exist (where?).
  201.           
  202.    
  203.      _________________________________________________________________
  204.    
  205.   SECTION 2: SETTING IT UP
  206.   
  207.     Q2.1: What is the current version of gnuplot?
  208.           The current version of gnuplot is 3.5, which is a bugfix
  209.           release over 3.4.
  210.           
  211.    Q2.2: Where can I get gnuplot?
  212.           [This information may be dated, due to the release of gnuplot
  213.           3.5. Please report any inaccuracies, if you find them. Ed.]
  214.           
  215.           All of the later addresses refer to ftp sites. Please note that
  216.           it is preferable for you to use the symbolic name, rather than
  217.           the IP address given in brackets, because that address is much
  218.           more subject to change.
  219.           
  220.           The official distribution site for the gnuplot source is
  221.           ftp.dartmouth.edu [129.170.16.4], the file is called
  222.           /pub/gnuplot/gnuplot.3.5.tar.Z. Official mirrors of that
  223.           distribution are (for Australia) monu1.cc.monash.edu.au
  224.           [130.194.1.101] and (for Europe) irisa.irisa.fr
  225.           [131.254.254.2]. You can also get it from your friendly
  226.           neighbourhood comp.sources.misc archive.
  227.           
  228.           MS-DOS and MS-Windows binaries are available from
  229.           
  230.           + oak.oakland.edu (North America) [141.210.10.117] as
  231.             pub/msdos/plot/gpt35*.zip,
  232.           + garbo.uwasa.fi (Europe) [128.214.87.1] as /pc/plot/gpt35*.zip
  233.             and
  234.           + archie.au (Australia) [139.130.4.6] as
  235.             micros/pc/oak/plot/gpt35*.zip.
  236.             
  237.    The files are: gpt35doc.zip, gpt35exe.zip, gpt35src.zip and
  238.           gpt35win.zip.
  239.           
  240.           There is a special MS-DOS version for 386 or better processors;
  241.           it is available from the official gnuplot sites as DOS34.zip.
  242.           
  243.           OS/2 2.x binaries are at ftp-os2.nmsu.edu [128.123.35.151], in
  244.           /os2/2.x/unix/gnuplt35.zip .
  245.           
  246.           Amiga sources and binaries are available from ftp.wustl.edu
  247.           [128.252.135.4] as /pub/aminet/util/gnu/gnuplot-3.5.lha; there
  248.           are numerous mirrors of this distribution, for example
  249.           ftp.uni-kl.de, oes.orst.edu or ftp.luth.se.
  250.           
  251.           The NeXTSTEP front end can be found at sonata.cc.purdue.edu and
  252.           cs.orst.edu.
  253.           
  254.           A version for OS-9/68K can be found at cabrales.cs.wisc.edu
  255.           [128.105.36.20] as /pub/OSK/GRAPHICS/gnuplot32x.tar.Z; it
  256.           includes both X-Windows and non - X-windows versions.
  257.           
  258.           A version of gnuplot for the Mac can reportedly be found on
  259.           archive.umich.edu and sumex-aim.stanford.edu, directories
  260.           unknown.
  261.           
  262.           People without ftp access can use an ftp-mail server; send a
  263.           message saying 'help' to bitftp@pucc.bitnet (for BITNET only)
  264.           or to ftpmail@ftp.dartmouth.edu.
  265.           
  266.           For a uuencoded copy of the the gnuplot sources (compressed tar
  267.           file), send this as the body of a message to
  268.           ftpmail@ftp.dartmouth.edu:
  269.           
  270.  
  271.         open
  272.         cd pub/gnuplot
  273.         mode binary
  274.         get gnuplot3.5.tar.Z
  275.         quit
  276.  
  277.    If you have some problem, you might need to stick
  278.           
  279.  
  280.         reply-to  <your-email-address-here>
  281.  
  282.    before all the above.
  283.           
  284.           It is a good idea to look for a nearby ftp site when
  285.           downloading things. You can use archie for this. See if an
  286.           archie client is installed at your system (by simply typing
  287.           archie at the command prompt), or send mail to archie@sura.net
  288.           with the word 'help' in both the subject line and the body of
  289.           the mail. However, be aware that the version you find at a near
  290.           ftp site may well be out of date; check the last modification
  291.           date and the number of bytes against the newest release at one
  292.           of the official servers.
  293.           
  294.    Q2.3: How do I get gnuplot to compile on my system?
  295.           As you would any other installation. Read the files README and
  296.           README.Install, edit the Makefile according to taste, and run
  297.           make or whatever is suitable for your operating system.
  298.           
  299.           If you get a complaint about a missing file libplot.a or
  300.           something similar when building gnuplot for X11, remove
  301.           -DUNIXPLOT from the TERMFLAGS= line, remove -lplot from the
  302.           DTBS= line and run again. If you are making X11 on a sun, type
  303.           'make x11_sun'.
  304.           
  305.    Q2.4: What documentation is there, and how do I get it?
  306.           The documentation is included in the source distribution. Look
  307.           at the docs subdirectory, where you'll find
  308.           
  309.           + a Unix man page, which says how to start gnuplot
  310.           + a help file, which also can be printed as a manual
  311.           + a tutorial on using gnuplot with LaTeX
  312.           + a quick reference summary sheet for TeX only
  313.             
  314.    PostScript copies of the documentation can be ftp'd from
  315.           ftp.dartmouth.edu, in pub/gnuplot, as manual.ps.Z and
  316.           tutorial.ps.Z
  317.           
  318.           A Chinese translation of the manual can be found on
  319.           ftp://servers.nctu.edu.tw/misc/environment/NCTU_EV/classnote/gn
  320.           uplot.ps.gz .
  321.           
  322.    
  323.      _________________________________________________________________
  324.    
  325.   SECTION 3: WORKING WITH IT
  326.   
  327.     Q3.1: How do I get help?
  328.           Give the 'help' command at the initial prompt. After that, keep
  329.           looking through the keywords. Good starting points are 'plot'
  330.           and 'set'.
  331.           
  332.           Read the manual, if you have it.
  333.           
  334.           Look through the demo subdirectory; it should give you some
  335.           ideas.
  336.           
  337.           Ask your colleagues, the system administrator or the person who
  338.           set up gnuplot.
  339.           
  340.           Post a question to comp.graphics.gnuplot or send mail to the
  341.           gatewayed mailing list info-gnuplot@dartmouth.edu. If you want
  342.           to subscribe to the mailing list, send mail to
  343.           info-gnuplot-request@dartmouth.edu, but please don't do this if
  344.           you can get comp.graphics.gnuplot directly. If you pose a
  345.           question there, it is considered good form to solicit e-mail
  346.           replies and post a summary.
  347.           
  348.    Q3.2: How do I print out my graphs?
  349.           The kind of output produced is determined by the 'set terminal'
  350.           command; for example, 'set terminal postscript' will produce
  351.           the graph in PostScript format. Output can be redirected using
  352.           the 'set output' command.
  353.           
  354.           As an example, the following prints out a graph of sin(x) on a
  355.           Unix machine running X - Windows.
  356.           
  357.  
  358.         gnuplot> plot [-6:6] sin(x)
  359.         gnuplot> set terminal postscript
  360.         Terminal type set to 'postscript'
  361.         Options are 'landscape monochrome "Courier" 14'
  362.         gnuplot> set output "sin.ps"
  363.         gnuplot> replot
  364.         gnuplot> set output              # set output back to default
  365.         gnuplot> set terminal x11        # ditto for terminal type
  366.         gnuplot> ! lp -ops sin.ps        # print ps - File (site dependent)
  367.         request id is lprint-3433 (standard input)
  368.         lp: printed file sin.ps on fg20.rz.uni-karlsruhe.de (5068 Byte)
  369.         !
  370.         gnuplot>
  371.  
  372.    Q3.3: How do I include my graphs in <word processor>?
  373.           Basically, you save your plot to a file in a format your word
  374.           processor can understand (using "set term" and "set output",
  375.           see above), and then you read in the plot from your word
  376.           processor.
  377.           
  378.           Details depend on the kind of word processor you use; use "set
  379.           term" to get a list of available file formats.
  380.           
  381.           Many word processors can use Encapsulated PostScript for
  382.           graphs. This can be generated by the "set terminal postscript
  383.           eps" command. Most MS-DOS word processors understand HPGL
  384.           (terminal type hpgl).
  385.           
  386.           With TeX, it depends on what you use to print your dvi files.
  387.           If you use dvips or dvi2ps, you can use Encapsulated
  388.           PostScript. For emTeX (popular for MS-DOS), you can use emTeX,
  389.           otherwise use the LaTeX terminal type, which generates a
  390.           picture environment.
  391.           
  392.           If nothing else helps, try using the pgm or ppm format and
  393.           converting it to a bitmap format your favourite word processor
  394.           can understand. An invaluable tool for this is Jef Poskanzer's
  395.           PBMPLUS package.
  396.           
  397.           The PBMPLUS package is available in the contrib distribution
  398.           for Xwindows. The original site for this is ftp.x.org:/contrib,
  399.           there are many mirrors, e.g.
  400.           ftp.th-darmstadt.de:/pub/X11/contrib or
  401.           sunsite.unc.edu:/pub/X11/contrib.
  402.           
  403.           The most recent release of pbm by the author is dated December
  404.           91 and is called pbmplus10dec91.tar.Z
  405.           
  406.           There is new version including lots of patches from the net
  407.           that is not maintained by the author called netpbm, with the
  408.           newest version called netpbm-7dec1993.tar.gz.
  409.           
  410.           Check archie (see Q2.2 ) for an archive site near you.
  411.           
  412.    
  413.      _________________________________________________________________
  414.    
  415.   SECTION 4: WANTED FEATURES
  416.   
  417.     Q4.1: Does gnuplot have hidden line removal?
  418.           Version 3.5 supports hidden line removal on all platforms
  419.           except MS-DOS; use the command
  420.           
  421.  
  422.         set hidden3d
  423.  
  424.    If someone can solve the 64K DGROUP memory problem, gnuplot would
  425.           support hidden line removal on MS-DOS as well. Version 3.2
  426.           supports limited hidden line removal.
  427.           
  428.    Q4.2: Does gnuplot support bar-charts/histograms/boxes?
  429.           As of version 3.4, it does.
  430.           
  431.    Q4.3: Does gnuplot support multiple y-axes on a single plot?
  432.           Yes, with two unofficial mods, multiplot.shar and borders.shar.
  433.           Send mail to woo@playfair.stanford.edu.
  434.           
  435.    Q4.4: Can I put multiple plots on a single page?
  436.           Yes, with the multiplot.shar mod. If you are using PostScript
  437.           output, check out mpage, which can be ftp'd from
  438.           ftp.eng.umd.edu:pub/misc/mpage-2.tar.Z
  439.           
  440.    Q4.5: Can I put both data files and commands into a single file?
  441.           This is a feature which will probably be in gnuplot 3.6, which
  442.           is in early development. Ask for the mixed.shar patch from
  443.           woo@playfair.stanford.edu.
  444.           
  445.    Q4.6: Can I put Greek letters and super/subscripts into my labels?
  446.           You might try using the LaTeX terminal type and putting text
  447.           like \alpha_{3} into it.
  448.           
  449.           If you use PostScript output, you might find something in the
  450.           Green subdirectory of the gpcontrb file (see Q5.3).
  451.           
  452.           David Denholm has written a PostScript terminal which allows
  453.           for super/and subscripts, such as a^x or { Symbol a }. Ftp to
  454.           sotona.phys.soton.ac.uk[152.78.192.42] and get divpost34.trm.
  455.           To install it, copy it over ~gnuplot/term/post.trm and
  456.           recompile. A never version is mattpost.trm, rewritten by Matt
  457.           Heffron.
  458.           
  459.    Q4.7: Can I do 1:1 scaling of axes?
  460.           Not easily.
  461.           
  462.    Q4.8: Can I put tic marks for x and y axes into 3d plots?
  463.           In version 3.5, you can.
  464.           
  465.    Q4.9: Does gnuplot support a driver for ?
  466.           To see a list of the available graphic drivers for your
  467.           installation of gnuplot, type "set term".
  468.           
  469.           Some graphics drivers are included in the normal distribution,
  470.           but are uncommented by default. If you want to use them, you'll
  471.           have to change ~gnuplot/term.h.
  472.           
  473.    Q4.10: Can I put different text sizes into my plots?
  474.           If you use PostScript output, you can use Dave Denholm's and
  475.           Matt Heffron's updated PostScript driver,
  476.           /sotona.phys.soton.ac.uk:/mattpost.trm (see also Q4.6 ).
  477.           
  478.    
  479.      _________________________________________________________________
  480.    
  481.   SECTION 5: MISCELLANEOUS
  482.   
  483.     Q5.1: I've found a bug, what do I do?
  484.           First, try to see whether it actually is a bug, or whether it
  485.           is a feature which may be turned off by some obscure set -
  486.           command.
  487.           
  488.           Next, see wether you have an old version of gnuplot; if you do,
  489.           chances are the bug has been fixed in a newer release.
  490.           
  491.           If, after checking these things, you still are convinced that
  492.           there is a bug, proceed as follows. If you have a fairly
  493.           general sort of bug report, posting to comp.graphics.gnuplot is
  494.           probably the way to go. If you have investigated a problem in
  495.           detail, especially if you have a context diff that fixes the
  496.           problem, please e-email a report to bug-gnuplot@dartmouth.edu.
  497.           The bug-gnuplot list is for reporting and collecting bug fixes,
  498.           the comp.graphics.gnuplot newsgroup will be more help for
  499.           finding work arounds or actually solving gnuplot related
  500.           problems. If you do send in a bug report, be sure and include
  501.           the version of gnuplot (including patchlevel), terminal driver,
  502.           operating system, an exact description of the bug and input
  503.           which can reproduce the bug. Also, any context diffs should be
  504.           referenced against the latest official version of gnuplot if at
  505.           all possible.
  506.           
  507.    Q5.2: Can I use gnuplot routines for my own programs?
  508.           Yes. John Campbell has written gplotlib, a version of gnuplot
  509.           as C subroutines callable from a C program. This is available
  510.           as gplotlib.tar.Z on the machine ftp.nau.edu in the directory
  511.           /pub/gplotlib.tar.Z. This library has been updated to be
  512.           compatible with version 3.5. Ask woo@playfair.stanford.edu.
  513.           
  514.    Q5.3: What extensions have people made to gnuplot? Where can I get
  515.           them?
  516.           [A new gpcontrb is under construction. A. Woo] 
  517.           
  518.           Extensions have been put into the file gpcontrb.tar.Z, which is
  519.           available with the 3.5 release, from the same places you can
  520.           download the main distribution from.
  521.           
  522.           Note that it has a size of 3.5 megabytes.
  523.           
  524.           It contains the following subdirectories:
  525.           
  526.           bigler subdirectory:
  527.           From: bigler@cicg-calcul.grenet.fr
  528.           Subject: Multiple plots from a Fortran program
  529.           budelsky subdirectory:
  530.           From: budelsky@haegar.ikp.uni-koeln.de
  531.           Subject: This is the information file for porting gnuplot 3.2
  532.           to OS-9/68000
  533.           byrne subdirectory:
  534.           From: "Margaret R. Byrne"
  535.           Subject: congp3d3 preprocessor to draw contour plots on
  536.           irregular regions.
  537.           clark subdirectory:
  538.           From: Michael Clark
  539.           Subject: data filtering: adds point_skip & point_offs
  540.           clift subdirectory:
  541.           From: ssclift@neumann.uwaterloo.ca (Simon Clift)
  542.           Subject: Re: Running gnuplot from Fortran, (and C)
  543.           green subdirectory:
  544.           From: Roque Donizete de Oliveira
  545.           Subject: PostScript Greek symbols in gnuplot, new prologue
  546.           hanna subdirectory:
  547.           From: gregor@kafka.saic.com (gregg hanna)
  548.           Subject: x11-library mode, gnulib_x11.[c,h],
  549.           xlibtest.c,makefile.xlib
  550.           klosowski subdirectory:
  551.           From: Carsten Steger
  552.           Subject: New file "klein.dat"
  553.           From: przemek@rrdstrad.nist.gov (Przemek Klosowski)
  554.           Subject: calling gnuplot from Fortran
  555.           kocaturk subdirectory:
  556.           From: mustafa@seas.smu.edu (Mustafa Kocaturk)
  557.           Subject: Histograms in gnuplot
  558.           richardson subdirectory:
  559.           From: amr@chiton.ucsd.edu (Tony Richardson)
  560.           Subject: Programmatic control of gnuplot from Unix
  561.           rosendorf subdirectory:
  562.           From: prf@jprix.che.wisc.edu
  563.           Subject: Multiple plots on a page
  564.           vanzandt subdirectory:
  565.           From: James R. Van Zandt
  566.           Subject: Spline generating program
  567.           white subdirectory:
  568.           From: gwhite@bionet.bio.dfo.ca
  569.           Subject: gnuplot 3.2 for Titan 3000
  570.           woo subdirectory:
  571.           From: "Alex Woo"
  572.           Subject: two additional title lines and fixes to errorbar style
  573.           
  574.           yamamoto subdirectory:
  575.           From: "NOBORU YAMAMOTO "
  576.           Subject: Re: gnuplot on Apple Macintosh, "diff -c" of version
  577.           3.0
  578.           (now includes binaries)
  579.           castro subdirectory:
  580.           From: maurice@bruce.cs.monash.edu.au (Maurice Castro)
  581.           Subject: Controlling gnuplot from another Windows program
  582.           grammes subdirectory:
  583.           From: ph12hucg@rz.uni-sb.de (Carsten Grammes)
  584.           Subject: Nonlinear least squares fit mechanism
  585.           henke subdirectory:
  586.           From: mgr@asgard.bo.open.de (Lars Hanke)
  587.           Subject: Re: Changes to gnuplot 3.3b9
  588.           walton subdirectory:
  589.           From: dwalton@athena.mit.edu (Dave Walton)
  590.           Subject: Inter Process Communication stuff
  591.           
  592.    Q5.4: Can I do heavy - duty data processing with gnuplot?
  593.           Gnuplot alone is not suited very well for this. One thing you
  594.           might try is fudgit, an interactive multi-purpose fitting
  595.           program written by Martin-D. Lacasse
  596.           (isaac@frodo.physics.mcgill.ca). It can use gnuplot as its
  597.           graphics back end and is available from ftp.physics.mcgill.ca
  598.           in /pub/Fudgit/fudgit_2.33.tar.Z [132.206.9.13], and from the
  599.           main Linux server, tsx-11.mit.edu [18.172.1.2] and its numerous
  600.           mirrors around the world as
  601.           /pub/linux/sources/usr.bin/fudgit-2.33.tar.z. Versions are
  602.           available for AIX, Data General, HP-UX, IRIX 4, Linux, NeXT,
  603.           Sun3, Sun4, Ultrix, OS/2 and MS-DOS. The MS-DOS version is
  604.           available on simtel20 mirrors (simtel20 itself has closed down)
  605.           in the "math" subdirectory as fudg_231.zip.
  606.           
  607.           Carsten Grammes has written a fitting program which goes
  608.           together with gnuplot; it is called gnufit and is available
  609.           from the official gnuplot sites, as the files gnufit12.info,
  610.           gnufit12.tar.gz (source) and gft12dos.zip (MS-DOS).
  611.           
  612.           Michael Courtney has written a program called lsqrft, which
  613.           uses the Levenberg - Marquardt - Algorithm for fitting data to
  614.           a function. It is avialiable from ftp.cdrom.com as
  615.           /pub/os2/2_x/unix/lsqrft13.zip; sources, which should compile
  616.           on Unix, and executables for MS-DOS and OS/2 2.x are included.
  617.           There is an interface to the OS/2 presentation manager.
  618.           
  619.           You might also want to look at the applications developed by
  620.           the Software Tools Group (STG) at the National Center for
  621.           Supercomputing Applications. Ftp to ftp.ncsa.uiuc.edu
  622.           [141.142.20.50] and get the file README.BROCHURE for more
  623.           information.
  624.           
  625.    Q5.5: I have ported gnuplot to another system, or patched it. What do
  626.           I do?
  627.           If your patch is small, mail it to bug-gnuplot@dartmouth.edu,
  628.           with a thorough description of what the patch is supposed to
  629.           do, which version of gnuplot it is relative to, etc. Please
  630.           don't mail it to the FAQ maintainer.
  631.           
  632.           If your modifications are extensive (such as a port to another
  633.           system), upload your modifications to
  634.           ftp.dartmouth.edu:/pub/dropoff. Please drop a note to
  635.           David.Kotz@dartmouth.edu, the maintainer of the gnuplot
  636.           subdirectory there, plus a note to bug-gnuplot@dartmouth.edu.
  637.           
  638.    
  639.      _________________________________________________________________
  640.    
  641.   SECTION 6: MAKING LIFE EASIER
  642.   
  643.     Q6.1: How do I plot two functions in non - overlapping regions?
  644.           Use a parametric plot. An example:
  645.           
  646.  
  647.         set parametric
  648.         a=1
  649.         b=3
  650.         c=2
  651.         d=4
  652.         x1(t) = a+(b-a)*t
  653.         x2(t) = c+(d-c)*t
  654.         f1(x) = sin(x)
  655.         f2(x) = x**2/8
  656.         plot [t=0:1] x1(t),f1(x1(t)) title "f1", x2(t), f2(x2(t)) title "f2"
  657.  
  658.    Q6.2: How do I run my data through a filter before plotting?
  659.           If your system supports the popen() - function, as Unix does,
  660.           you should be able to run the output through another process
  661.           such as a short awk program (use the "help plot datafile"
  662.           command for an example). Unfortunately, in 3.2, there is a
  663.           rather short limitation on the maximum argument length, so your
  664.           command line may be truncated (usually, this will mean that awk
  665.           cannot find the filename). Also, you may need to escape the $ -
  666.           characters in your awk programs.
  667.           
  668.           As of version 3.4, gnuplot includes the thru - keyword for the
  669.           plot command for running data files through a gnuplot - defined
  670.           function.
  671.           
  672.           You can also get divhack.trm from
  673.           sotona.phys.soton.ac.uk[152.78.192.42] via anonymous ftp. It
  674.           allows expressions of the kind
  675.           
  676.  
  677.         gnuplot> plot "datafile" using A:B:C
  678.  
  679.    where A,B,C,... are now either a column number, as usual, or an
  680.           arbitrary expression enclosed in ()'s, and using $1,$2,etc to
  681.           access the data columns.
  682.           
  683.    Q6.3: How do I make it easier to use gnuplot with LaTeX?
  684.           There is a set of LaTeX macros and shell scripts that are meant
  685.           to make your life easier when using gnuplot with LaTeX. This
  686.           package can be found on ftp.dartmouth.edu [129.170.16.54] in
  687.           pub/gnuplot/latex.shar, by David Kotz. For example, the program
  688.           "plotskel" can turn a gnuplot-output file plot.tex into a
  689.           skeleton file skel.tex, that has the same size as the original
  690.           plot but contains no graph. With the right macros, the skeleton
  691.           can be used for preliminary LaTeX passes, reserving the full
  692.           graph for later passes, saving tremendous amounts of time.
  693.           
  694.    Q6.4: How do I save and restore my settings?
  695.           Use the "save" and "load" commands for this; see "help save"
  696.           and "help load" for details.
  697.           
  698.    Q6.5: How do I plot lines (not grids) using splot?
  699.           If the data in a data file for splot is arranged in such a way
  700.           that each one has the same number of data points (using blank
  701.           lines as delimiters, as usual), splot will plot the data with a
  702.           grid. If you want to plot just lines, use a different number of
  703.           data entries (you can do this by doubling the last data point,
  704.           for example). Don't forget to set parametric mode, of course.
  705.           
  706.    Q6.6: How do I plot a function f(x,y) which is bounded by other
  707.           functions in the x-y plain?
  708.           An example:
  709.           
  710.  
  711.         f(x,y) = x**2 + y **2
  712.         x(u) = 3*u
  713.         yu(x) = x**2
  714.         yl(x) = -x**2
  715.         set parametric
  716.         set cont
  717.         splot [0:1] [0:1] u,yl(x(u))+(yu(x(u)) - yl(x(u)))*v,\
  718.         f(x(u), (yu(x(u)) - yl(x(u)))*v)
  719.  
  720.    Q6.7: How do I get rid of <feature in a plot>?
  721.           Usually, there is a set command to do this; do a
  722.           
  723.  
  724.         gnuplot> ?set no
  725.  
  726.    for a short overview.
  727.           
  728.    
  729.      _________________________________________________________________
  730.    
  731.   SECTION 7: KNOWN PROBLEMS
  732.   
  733.     Q7.1: Gnuplot is not plotting any points under X11! How come?
  734.           Very probably, you still are using an old version of
  735.           gnuplot_x11. Remove that, then do a full installation.
  736.           
  737.           On VMS, you need to make several symbols:
  738.           
  739.  
  740.         $ gnuplot_x11 :== $disk:[directory]gnuplot_x11
  741.         $ gnuplot :== $disk:[directory]gnuplot.exe
  742.         $ def/job GNUPLOT$HELP disk:[directory]gnuplot.hlb
  743.  
  744.    Then run gnuplot from your command line, and use
  745.           
  746.  
  747.         gnuplot> set term x11
  748.  
  749.    Q7.2: My isoline data generated by a Fortran program is not handled
  750.           correctly. What can I do?
  751.           One known cause for this is the use of list - directed output
  752.           (as in WRITE(10,*) for generating blank lines. Fortran uses ASA
  753.           carriage control characters, and for list - directed output
  754.           this results in a space being output before the newline.
  755.           Gnuplot does not like this. The solution is to generate blank
  756.           lines using formatted output, as in WRITE(10,'()'). If you use
  757.           carriage return files in VMS Fortran, you may have to open the
  758.           file with OPEN(...,CARRIAGECONTROL='DTST') or convert it using
  759.           the DECUS utility ATTRIB.EXE:
  760.           
  761.  
  762.         VMS> ATTRIB/RATTRIB=IMPDTED FOR010.DAT
  763.  
  764.    Q7.3: Why does gnuplot ignore my very small numbers?
  765.           Gnuplot treats all numbers less than 1e-08 as zero, by default.
  766.           Thus, if you are trying to plot a collection of very small
  767.           numbers, they may be plotted as zero. Worse, if you're plotting
  768.           on a log scale, they will be off scale. Or, if the whole set of
  769.           numbers is "zero", your range may be considered empty:
  770.           
  771.  
  772.         gnuplot> plot 'test1'
  773.         Warning: empty y range [4.047e-19:3e-11], adjusting to [-1:1]
  774.         gnuplot> set yrange [4e-19:3e-11]
  775.         gnuplot> plot 'test1'
  776.                      ^
  777.          y range is less than `zero`
  778.  
  779.    The solution is to change gnuplot's idea of "zero":
  780.           
  781.  
  782.         gnuplot> set zero 1e-20
  783.  
  784.    For more information,
  785.           
  786.  
  787.         gnuplot> help set zero
  788.  
  789.    Q7.4: Gnuplot is plotting nothing when run via gnuplot <filename>!
  790.           What can I do?
  791.           Put a pause -1 after the plot command in the file.
  792.           
  793.    Q7.5: My formulas are giving me nonsense results! What's going on?
  794.           Gnuplot does integer, and not floating point, arithmetic on
  795.           integer expressions. For example, the expression 1/3 evaluates
  796.           to zero. If you want floating point expressions, supply
  797.           trailing dots for your floating point numbers. Example:
  798.           
  799.  
  800.         gnuplot> print 1/3
  801.                 0
  802.         gnuplot> print 1./3.
  803.                 0.333333
  804.  
  805.    This way of evaluating integer expressions is shared by both C and
  806.           Fortran.
  807.           
  808.    
  809.      _________________________________________________________________
  810.    
  811.   SECTION 8: CREDITS
  812.   
  813.    This list was initially compiled by John Fletcher with contributions
  814.    from Russell Lang, John Campbell, David Kotz, Rob Cunningham, Daniel
  815.    Lewart and Alex Woo. Reworked by Thomas Koenig from a draft by Alex
  816.    Woo, with corrections and additions from Alex Woo, John Campbell,
  817.    Russell Lang, David Kotz and many corrections from Daniel Lewart; Axel
  818.    Eble and Jutta Zimmermann helped with the conversion to HTML.
  819.    
  820.    
  821.      _________________________________________________________________
  822.    
  823.     Thomas Koenig, ig25@rz.uni-karlsruhe.de, 1994-03-28
  824. -- 
  825. Thomas Koenig, ig25@rz.uni-karlsruhe.de, ig25@dkauni2.bitnet,
  826. The joy of engineering is to find a straight line on a double
  827. logarithmic diagram.
  828.